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Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The present document is part the 32.300-series covering the 3"* Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication Management; Configuration Management, as identified 
below: 

32.301: "Notification Integration Reference Point (IRP): Requirements"; 

32.302: "Notification Integration Reference Point (IRP): Information Service"; 

32.303: "Notification Integration Reference Point (IRP): CORBA solution set"; 

32.304: "Notification Integration Reference Point (IRP): CMIP solution set". 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 

The Itf-N interface is built up by a number of Integration Reference Points (IRPs) and a related Name Convention, 
which realise the functional capabilities over this interface. The basic structure of the IRPs is defined in 
3GPP TS 32.101 [5] and 3GPP TS 32.102 [6]. 

Network Elements (NEs) under management and element managers generate notifications of events about occurrences 
within the network. Different kinds of events carry different kinds of information. For instance a new alarm as specified 
in Alarm IRP: Information Service [1], is one possible kind of event, an object creation as specified in Basic CM IRP : 
Information Service [8] is another possible kind of event. 

Information of an event is carried in notification. An IRP Agent (typically an EM or a NE) emits notifications. 
IRPManager (typically a network management system) receives notifications. The purpose of Notification IRP is to 
define an interface through which an IRPManager can subscribe to IRP Agent for receiving notifications. 

This IRP bases its design on work captured in ITU-T Recommendation X.734 [2], OMG Notification Service [4]. The 
central design ideas are: 

• Separation of notification Consumers (IRPManagers) from Producers (IRP Agents); 

• Notifications are sent to IRPManagers without the need for IRPManagers to periodically check for new 
notifications. 

Common characteristics related to notifications in all other IRPs are gathered in one IRP. 
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Scope 



The purpose of Notification IRP is to define an interface through which an IRPManager can subscribe to an IRP Agent 
for receiving notifications. The present document is the "Information Service" of Notification IRP. It defines, for the 
purpose of subscribing to an IRP Agent for receiving notifications, the information observable and controlled by 
management system's client and it also specifies the semantics of the interactions used to carry this information. It also 
defines the information common to all notifications which is called the notificationHeader. 

An IRP Agent supporting this IRP IS may emit one or multiple categories of notifications, such as alarms (as specified 
in Alarm IRP: Information Service [1]) and others. This IRP IS defines a mechanism that IRPManager can use to 
determine the categories of notifications supported by an IRP Agent. It also defines a mechanism (subscribe and 
unsubscribe operations) that IRPManager can use to specify the categories of notifications IRP Agent should emit to 
IRPManager during subscription. It also defines a mechanism (getSubscriptionlds operation) that IRPManager can use 
to check which categories of notifications it has subscribed to. IRPManager can set and change filter criteria applicable 
during the life-cycle of a subscription. IRPManager can also exercise flow-control on IRP Agent's emission of 
notifications (suspendSubscription and resumeSubscription operations). 

Using different managerReference, an IRPManager can subscribe several times. It will result in multiple subscriptions. 
As far as IRP Agent is concerned, notifications are sent to multiple "places". 

Using the same managerReference, an IRPManager can subscribe several times specifying different categories of 
notifications. 

This IRP IS does not specify information that is carried in some but not all notifications. That kind of information is 
specified in other IRP ISs involved. For example, perceivedSeverity is a piece of information specific for 
notifications carrying alarm information. This information is not defined in the present document but in Alarm IRP : 
Information Service [1]. 

How IRPManager discovers the IRP Agent's address or reference (so that IRPManager can invoke an operation) is 
outside the scope of the present document. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 32.1 1 1-2: "Telecommunication management; Fault Management; Part 2: Alarm 

Integration Reference Point (IRP): Information service". 

[2] ITU-T Recommendation X.734 (1992): "Information technology - Open Systems Interconnection - 

Systems management: Event report management function". 

[3] 3GPP TS 32.300: "Telecommunication management; Configuration Management (CM); Name 

convention for Managed Objects". 

[4] OMG: "OMG Notification Service", http://www.omg.org/technologv/documents/ 

[5] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[6] 3GPP TS 32.102: "Telecommunication management; Architecture". 
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[7] 3GPP TS 32.301: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Requirements". 

[8] 3GPP TS 32.602: "Telecommunication management; Configuration Management (CM); Basic CM 

Integration Reference Point (IRP) information service". 

[9] 3GPP TS 32.622: "Telecommunication management; Configuration Management (CM); Generic 

network resources Integration Reference Point (IRP): Network Resource Model (NRM)". 

[10] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Information service". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in 3GPP TS 32.101 [5], 3GPP TS 32.102 [6] 
and 3GPP TS 32.301 [7] and the following apply: 

IRPAgent: See 3GPP TS 32.102 [6]. 

IRPManager: See 3GPP TS 32.102 [6]. 

event: it is an occurrence that is of significance to network operators, the NEs under surveillance and network 
management applications 

Events can indicate many types of network management information, such as network alarms, network configuration 
change information and network performance data. 

notification: it refers to the transport of information regarding events from event producer to consumer (receiver) 
In this IRP, notification is used to carry information about network events from IRPAgent to IRPManager. Producer 
sends notifications to consumers as soon as new events occur. Consumer does not need to check ("pull") for events. 

IRP: See 3GPP TS 32.102 [6]. 

notification category: it refers to the set of notifications of one 3GPP IRP Information Service specification 

A Notification Category is identified by the name of the IRP specification and the IRP specification version number. 

qualifiers: the meaning of qualifiers for operations, parameters and information attributes (whether they are 
Mandatory(M)/ Conditional(C)/ Optional(O)) defined in the present (Information Service) document is provided in 
3GPPTS 32.102 [6] 

Moreover, qualifiers of information attributes, when those information attributes are re-used in other IRP ISs, obey to 
the following rule: Mandatory and Conditional qualifiers of information attributes shall always be the same in other 
IRPs ISs, Optional qualifiers of information attributes may be set to either Optional or Mandatory in the other IRP ISs. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CM Configuration Management 

CORBA Common Object Request Broker Architecture 

DN Distinguished Name 

EM Element Manager 

IOC Information Object Class 

IRP Integration Reference Point 

IS Information Service 

NE Network Element 

NM Network Manager 

NR Network Resource 

NRM Network Resource Model 

OMG Object Management Group 
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ss 

UML 



Solution Set 

Unified Modelling Language (OMG) 



4 System overview 

4.1 System context for Notification 

Figure 1 and figure 2 identify System contexts of Notification IRP in terms of implementations called IRPAgent and 
IRPManager. 

"IRPManager" depicts a process that interacts with IRPAgent for the purpose of receiving network Notifications via this 
IRP. IRPAgent detects network events. IRPAgent sends IRPManagers notifications carrying the events. Examples of 
IRPManagers can be a process running supporting network Notification logging device or supporting network 
Notification viewing devices (such as a local craft terminal) or a process running within a Network Manager (NM) as 
shown in figure 1 and figure 2. IRPAgent implements and supports this IRP. IRPAgent can run within one Element 
Manager (EM) with one or more NEs (see figure 1) or run within one NE (see figure 2). In the former case, the 
interfaces (represented by a thick dotted line) between the EM and the NEs are not subject of this IRP. Whether EM 
and NE share the same hardware system is not relevant to this IRP either. By observing the interaction across the IRP, 
one cannot deduce if EM and NE are integrated in a single system or if they run in separate systems. 
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Figure 1 : System Context A 
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Figure 2: System Context B 
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5 
5.1 



Information Object Classes 

Information entities imported and local labels 



Label reference 


Local label 


3GPP TS 32.622 [9], information object class, Top 


Top 


3GPP TS 32.312 [10], information object class, managedGenericIRP 


managedGenericIRP 


3GPP TS 32.622 [9], information object class, IRPAgent 


IRPAgent 



5.2 Class Diagram 

5.2.1 Attributes and relationships 

This subclause depicts the set of lOCs that encapsulate information within the notification IRP. The intent is to identify 
the information required for the notification IRP implementation of its operations and notification emission. This 
subclause provides the overview of all information object classes in UML. Subsequent subclauses provides more 
detailed specification of various aspects of these information object classes. 



<lnformationObjectGlass> 
NotificationIRP 



#hasRegisteredWith v 



subscriptionRegislralion 



#hasRegistration 



«lnformationObjectClass» 
NtSubscriber 



subscription 



1..* 



# ntfManagerReference 



#isSubscribedBy 



#hasSjbscription 



<lnformationObjectClass» 
NtfSubscription 



#ntfSubscriptionld 

# ntfSubscriptionState 

# ntfTimeTlck 

# ntfTimeTlckTimer 

# ntfNotificationCategorySet 

# ntfFilter 



Figure : 

5.2.2 Inineritance 

This subclause depicts the inheritance relationships that exist between information object classes. 



<lnformationObjectClass>: 
ManagedGenericIRP 



A 



«lnformationObiectClass> 
NotificationIRP 



Figure 
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5.3 Information object classes definition 
5.3.1 NtfSubscriber 



5.3.1.1 



Definition 



This information object represents a Subscriber from a notification IRP perspective: a subscriber is frilly identified by a 
manager reference. An IRPManager using multiple managerReference attributes to subscribe will result in multiple 
NtfSubscriber instances. It inherits from IOC Top. 



5.3.1.2 



Attributes 



Attribute name 


Support Qualifier 


ntfManagerReference 


M 



5.3.2 NtfSubscription 



5.3.2.1 



Definition 



This information object represents a subscription that have been requested by an IRPManager and created. It inherits 
from IOC Top. 



5.3.2.2 



Attributes 



Attribute name 


Support Qualifier 


ntfSubscriptionId 


M 


subscriptionState 


M 


ntfTimelick 


M 


ntfTimelickTimer 


M 


ntfNotificationCategorySet 


M 


ntfFilter 


M 
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5.3.2.3 State diagram 

The diagram below depicts states that can be supported by a NtfSubscription. 



subscrit)e / 

ntfTlmeTickTiqier 

initialised 



ntfTimeTicl<TimGr=0 / 
ntfSubscription is not 

deleted ^_^etSubscriptionStatus / 

neTickTimer 
litialised 



/ ^ ntfTimeT 
/ 1 re-init 




resumes ubscription 
notSuspended 



ntfTimeTickTimer=0 
/ ntfSubscription 

(and possibly 
ntfSubscriber) is 
deleted.,,,^''^ 



resurrteSubscription 



susp^Subscription 



^spendSubscriptfbn 
suspended 




unsubscribe / 

ntfSubscription (and 

possibly ntfSubscriber) is 

deleted 



Figure : 

NotificationIRP can lose the list of managerRef erence that identifies current IRPManagers under subscription. 
Under this condition, IRP Agent is incapable of sending events to the affected subscriber(s). 

This Notification IRP recommends that IRPManager should invoke the getSubscriptionStatus operation 
periodically to confirm that IRP Agent still has the IRPManager's reference in its list. In case getSubscriptionStatus 
returns the exception operation_failed, IRPManager should assume that IRP Agent has lost the IRPManager's reference. 

This IRP does not recommend the frequency IRPManager should use to invoke getSubscriptionStatus 
operation. 

5.3.3 NotificationIRP 
5.3.3.1 Definition 

This information object represents a notification IRP. It inherits from IOC managedGenericIRP. 

5.4 Information relationships definition 
5.4.1 subscription (M) 
5.4.1.1 Definition 

This relationship defines the relationship between a NtfSubscriber and its current subscriptions. 
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5.4.1.2 



Roles 



Name 


Definition 


isSubscribedBy 


This role represents the one who has subscribed. It can be played by instances of IOC 
NtfSubscriber 


hasSubscription 


This role represents the subscriptions which were made and not unsubscribed. It can be 
played by instances of IOC NtfSubscription 



5.4.1.3 



Constraints 



Name 


Definition 


inv_notificationCategoriesAIIDistinct 


"the notification categories contained in the ntfNotificationCategorySet attribute of 
NtfSubscription playing the role hasSubscription are all distinct from each other" 



5.4.2 subscriptionRegistration (M) 



5.4.2.1 Definition 

This relationship defines the relationship between the NotificationIRP and the current subscribers of notifications. 

5.4.2.2 Roles 



Name 


Definition 


hasRegistration 


This role represents the entities to which IRPAgent will notify events. It is played by 
instances of IOC NtfSubscriber 


HasRegisteredWith 


This role represents the NotificationIRP to which an IRPIVIanager has subscribed. It is 
played by instances of IOC NotificationIRP 



5.4.2.3 



Constraints 



Name 


Definition 


inv_uniqueManagerReference 


"all NtfSubscriber involved in the subscriptionRegistration relationship with 
NotificationIRP are distinguished from each other by their ntflVlanagerReference Attribute 
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5.5 



Information attributes definition 



This subclause defines the semantics of the Attributes used in Information Object Classes. 

5.5.1 Definitions and legal values 



Attribute Name 


Definition 


Legal Values 


ntfSubscriptionId 


It identifies uniquely a subscription 


N/A 


ntfSusbcriptionState 


It indicates the activation state of a subscription 


"suspended": the 
subscription is 
suspended 
"notSuspended": the 
subscription is active 


ntfTimeTicl< 


this Attribute represents the initial value of ntflimelickTimer. It is In unit 
of whole minute. This value defines a time window within which 
IRPManager intends to invoke getSubscriptionStatus (or 
subscribe) operation to confirm its subscription. A special value 
indicates infinity which is such that timer will never expire and IRPAgent 
needs other means to decide when to delete resources allocated to the 
IRPManager 


Integer greater or 
equal to 15, OR 
special infinite value 


ntfTimeTicl<Timer 


this Attribute represents the current value of a timer 


integer greater or 
equal to zero 


ntfNotificationCategorySet 


this Attribute represents a set of notification categories (see also 
Definition of notification category in subclause 3.1) 




ntfFilter 


this Attribute represents the filter of a subscription. The filter can be 

applied to parameters of notification header (see 

Notification IRPNotification interface) and to parameters of notifications 

defined as filterable in other IRP ISs. 

IRPAgent shall notify IRPManagers if the event satisfies the filter 

constraint. 




ntflVlanagerReference 


this Attribute contains the reference of a manager. It uniquely identifies 
a subscriber 





5.5.2 Constraints 

"ntfTimeTickTimer is lower or equal to ntfTimeTick" . 
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Interface Definition 



6.1 Class diagram representing interfaces 



«lnterface» 
Notification IRPManagement 



■ subscribeO 

■ unsubscribeO 



«lnterface» 
SubscriberManagement 



■ getSubscriptionldsO 



«lnterface» 
SubscriptionStatusOperations 



- getSubscriptionStatusO 

«lnterface» 
SubscriptionFilterOperations 



■ changeSubscriptionFilterO 



«lntei1ace» 
SubscriptionSuspendOperations 0.. 1 



suspendSubscriptionO 
- resumeSubscriptionO 




0..1 



«lnterface>> 
NotificationlRPNotifi cation 



This «interface» defines the N 

notificationHeader. Other «interface», 
such as Alarm IRPNotification, inherits from 
this «interface» and the 
notifications emitted bythese other 
«interface» shall support the 
inherited notificationHeader. 



«lnterface» 0-1 

IRPManagementOperations 



- getNotifioationCategoriesO 



Figure 



6.2 



Generic rules 



Rule 1: Each operation with at least one input parameter supports a pre-condition valid_input_parameter which 

indicates that all input parameters shall be valid with regards to their information type. Additionally, each 
such operation supports an exception operation_failed_invalid_input_parameter which is raised when 
pre-condition valid_input_parameter is false. The exception has the same entry and exit state. 

Rule 2: Each operation with at least one optional input parameter supports a set of pre-conditions 

supported_optional_input_parameter_xxx where "xxx" is the name of the optional input parameter and 
the pre-condition indicates that the operation supports the named optional input parameter. Additionally, 
each such operation supports an exception operation_failed_unsupported_optional_input_parameter_xxx 
which is raised when (a) the pre-condition supported_optional_input_parameter_xxx is false and (b) the 
named optional input parameter is carrying information. The exception has the same entry and exit state. 

Rule 3: Each operation shall support a generic exception operation_failed_intemal_problem which is raised when 
an internal problem occurs and that the operation cannot be completed. The exception has the same entry 
and exit state. 
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6.3 notificationlRPManagement Interface 
6.3.1 Operation subscribe (M) 



6.3.1.1 



Definition 



IRPManager invokes this operation to establish subscription to receive network events via notifications, under the fiher 
constraint specified in this operation. 



6.3.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information Type 


Comment 


managerReference 


IVI 


NtfSubscriber.ntflVlanagerReference 


It specifies the reference of IRPManager to which 
notifications shall be sent. 


timeTicl< 





NtfSubscription.ntfTimeTicl< 


It specifies the value of a timer hold by 
Notification IRP for the subject IRPManager. 
The value is in unit of whole minute. 
A special infinite value is assumed when parameter 
is absent or present but equal to zero. 


notification 
Categories 





SET OF (name of IRP, version of 
IRP) 


It identifies one or more Notification Category (see 
also Definition in subclause 3.1) 


filter 





NtfSubscription.ntf Filter 

Filter constraint grammar is SS 
dependent 


It specifies a filter constraint that IRPAgent shall use 
to filter notification of the category specified in 

notif icationCategories parameter. 

If this parameter is absent, then no filter constraint 

shall be applied. 



6.3.1.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


subscription Id 


M 


NtfSubscription.ntfSubscriptionId 


It holds an unambiguous identity of this 
subscription. 


status 


M 


ENUM (OperationSucceeded, 

OperationFailedExistingSubscription, 

OperationFailed) 


If subscriptionCreated is true, status = 

OperationSuceeded. 

If operation_failed_existing_subscription is true, 

status = OperationFailedExistingSubscription 

If operationjailed is true, status = 

OperationFailed. 



6.3.1.4 



Pre-condition 



notificationCategoriesNotAUSubscribed OR notificationCategoriesParameterAbsentAndNotAllSubscribed. 



Assertion Name 


Definition 


notificationCategoriesNotAIISubscribed 


"at least one notificationCategory identified in the 
notificationCategories input parameter is supported by 
IRPAgent and is not a member of the 
ntfNotificationCategorySet attribute of an NtfSubscription 
which is involved in a subscription relationship with the 
NtfSubscriber identified by the managerReference input 
parameter". 


notificationCategoriesParameterAbsentAndNotAIISubscribed 


" notificationCategories input parameter is absent and at 
least one notificationCategory supported by IRPAgent is 
not a member of the ntfNotificationCategorySet attribute of 
an ntfSsubscription which is involved in a subscription 
relationship with the NtfSubscriber identified by the 
managerReference input parameter" 
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6.3.1.5 



Post-condition 



subscriberPossiblyCreated AND subscriptionCreated. 



Assertion Name 


Definition 


subscriberPossiblyCreated 


"an NtfSubscriber witli a ntflVlanagerReference attribute equal to the value of the 
managerReference input parameter is involved in a subscriptionRegistration relationship 
with NotificationIRP" 


subscriptionCreated 


"an NtfSubscription has been created according to the following rules: 

• subscriptionState attribute value has been set to "notSuspended"; 

• ntfTimeTick attribute value has been set to the value of the timeTick input 
parameter if this value was higher or equal to 1 5, or set to 1 5 if this parameter 
value was between 1 and 15, or set to a special infinite value if the parameter 
value was lower or equal to or if parameter was absent; 

• ntfTimeTickTimer has been reset with the value of timeTick attribute; 

• ntfFilter attribute value has been set to the value of the filter input parameter if 
present; 

• NtfSubscription is involved in a subscription relationship with the NtfSubscriber 
identified by the managerReference input parameter; 

• attribute ntfNotificationCategorySet of NtfSubscription contains EITHER the 
notification categories identified by the notificationCategories input parameter that 
were not already contained in the ntfNotificationCategorySet attribute of other 
NtfSubscription of the same NtfSubscriber identified by the managerReference 
input parameter OR if notificationCategories input parameter is absent, all 
notification categories supported by IRPAgent that were not already contained in 
the ntfNotificationCategorySet attribute of other subscriptions of the same 
NtfSubscriber identified by the managerReference input parameter". 



6.3.1.6 



Exceptions 



Name 


Definition 


operation_failed_existing_subscription 


Condition: (notificationCategoriesNotAIISubscribed OR 
notificationCategoriesParameterAbsentAndNotAIISubscribed) not true 
Returned Information: The output parameter status 
Exit state: Entry State 


Operationjailed 


Condition: Post-condition is false 

Returned Information: The output parameter status 

Exit state: Entry State 



6.3.2 Operation unsubscribe (M) 



6.3.2.1 



Definition 



The IRPManager invokes this operation to cancel subscriptions. The IRPManager can cancel one subscription made 
with a managerReference by providing the corresponding subscriptionid or all subscriptions made with the same 
managerReference by leaving the subscriptionid parameter absent. 



6.3.2.2 



Input parameters 



Parameter Name 


Qualifier 


Information Type 


Comment 


managerReference 


M 


NtfSubscriber.ntflVlanagerReference 


It specifies the reference of an IRPIVIanager. 


subscriptionid 





NtfSubscription. ntfSubscriptionId 


It holds a subscriptionid carried as the output 
parameter in the subscribe operation. 
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6.3.2.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (OperationSucceeded, 
OperationFailed) 


If (subscriptionDeleted OR allSubscriptionDeleted) is true, 

status = OperationSucceeded. 

If operation failed is true, status = OperationFailed. 



6.3.2.4 Pre-condition 

validSubscriptionld&ManagerReference OR SubscriptionldAbsent&ValidManagerReference. 



Assertion Name 


Definition 


validSubscriptionld&ManagerReference 


"the NtfSubscription identified by subscriptionid input parameter is 
involved in a subscription relationship with the NtfSubscriber identified 
by the managerReference input parameter" 


SubscriptionldAbsent&ValidlVlanagerReference 


"subscriptionid input parameter is absent and the NtfSubscriber 
identified by the managerReference input parameter exists" 



6.3.2.5 



Post-condition 



subscriptionDeleted OR allSubscriptionDeleted. 



Assertion Name 


Definition 


subscriptionDeleted 


"the NtfSubscription identified by subscriptionid input parameter is no more involved in a 
subscription relationship with the NtfSubscriber identified by the managerReference input 
parameter and has been deleted. If this NtfSubscriber has no more NtfSubscription, it is deleted 
as well." 


allSubscriptionDeleted 


"in the case subscriptionid input parameter was absent, the NtfSubscriber identified by the 
managerReference input parameter is no more involved in any subscription relationship and is 
deleted, the corresponding NtfSubscription have been deleted as well." 



6.3.2.6 



Exceptions 



Name 


Definition 


Operationjailed 


Condition: Pre-condition is false or post-condition is false 
Returned Information: The output parameter status 
Exit state: Entry State 



6.4 subscriberManagement Interface 

6.4.1 Operation getSubscriptionlds (O) 



6.4.1.1 



Definition 



IRPManager invokes this operation to get the values of all still valid (not unsubscribed or removed by IRP Agent) 
subscriptionlds assigned by NotificationIRP as result of previously subscribe operations performed by this 
IRPManager. 



6.4.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information Type 


Comment 


managerReference 


M 


NtfSubscriber.ntflVlanagerReference 


It specifies the reference of IRPManager that requests 
the set of identifiers of active subscriptions related to 
this IRPManager. 
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6.4.1.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


subscriptionldSet 


M 


SET OF NtfSubscription.ntfSubscriptionId 
where NtfSubscription is involved in a 
subscription relationsliip with the 
NtfSubscriber identified by the 
managerReference input parameter 


It holds a set of the subscriptionid, each 
assigned as output parameter in previous 
subscribe operations invoked by the current 
IRPManager. This value should contain no 
information if the IRPIVIanager did not yet 
subscribed to that System or System lost all 
subscription related information. 


status 


M 


ENUIVI (Operation succeeded, Operation 
failed) 


If validSubscriptionldSet is true, status = 

OperationSuceeded. 

If operationjailed is true, status = 

OperationFailed. 



6.4.1.4 Pre-condition 

validManagerReference. 



Assertion Name 


Definition 


validlVlanagerReference 


"the NtfSubscriber identified by the managerReference input parameter exists" 



6.4.1.5 

None specific 

6.4.1.6 



Post-condition 



Exceptions 



Name 


Definition 


Operationjailed 


Condition: Pre-condition is false 

Returned Information: The output parameter status 

Exit state: Entry State 



6.5 subscriptionStatusOperations Interface 
6.5.1 Operation getSubscriptionStatus (O) 



6.5.1.1 



Definition 



IRPManager invokes this operation to query the subscription status of a particular subscription. IRPManager can use 
getSubscriptionStatus operation to know about the filter constraint in effect, the state of subscription (i.e. if subscription 
is suspended/inactive or resumed/active), the timeXick value that may be set at subscribe invocation time and the 
notificationCategory currently in used in the subscription. 



6.5.1.2 



Input parameters 



Parameter 
Name 


Qualifier 


Information Type 


Comment 


subscriptionid 


M 


NtfSubscription. ntfSubscriptionId 


It holds the subscriptionid carried as the output parameter in 
the subscribe operation. 
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6.5.1.3 



Output parameters 



Parameter Name 


Qualifier 


IVIatching Information 


Comment 


notification CategorySet 


M 


NtfSubscription.ntfNotificationCategorySet 


It identifies the notification 
Category(ies) supported in this 
subscription. 


filterlnEffect 





NtfSubscription.ntf Filter 


It contains the filter constraint currently 
set. 


SubscriptionState 





NtfSubscription.ntfSubscriptionState 




timeTicl< 





NtfSubscription.ntfTimeTick 


It carries the same value as the one in 
subscribe operation 


status 


M 


ENUIVI (Operation succeeded, Operation 
failed) 


If (timeTickReset) is true, status = 

OperationSucceeded. 

If operationjailed is true, status = 

OperationFailed. 



6.5.1.4 Pre-condition 

validSubscriptionld. 



Assertion Name 


Definition 


validSubscriptionld 


"the NtfSubscription identified by subscription Id input parameter is involved in a subscription 
relationship" 



6.5.1.5 



timeTickReset 



Post-condition 



Assertion Name 


Definition 


timeTickReset 


"the ntfTimeTickTimer attribute of NtfSubscription identified as input parameter has been 
reset with the value of ntfTlmeTick attribute of the same NtfSubscription " 



6.5.1.6 



Exceptions 



Name 


Definition 


Operationjailed 


Condition: Pre-condition is false or post-condition is false 
Returned Information: The output parameter status 
Exit state: Entry State 



6.6 subscriptionFilterOperations Interface 
6.6.1 Operation changeSubscriptionFilter (O) 
6.6.1.1 Definition 

IRPManager invokes this operation to replace the present fiher constraint with a new one. 



6.6.1.2 



Input parameters 



Parameter 
Name 


Qualifier 


Information Type 


Comment 


subscription Id 


M 


NtfSubscription. ntfSubscriptionId 


It carries the subscription Id carried as the output parameter 
in the subscribe operation. 


filter 


M 


NtfSubscription.ntf Filter 


It specifies a filter constraint 
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6.6.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (Operation succeeded, Operation 
failed) 


If filterUpdated is true, status = 

OperationSuceeded. 

If operationjailed is true, status = 

OperationFailed. 



6.6.1.4 Pre-condition 

validNtfSubscriptionld. 



Assertion Name 


Definition 


validNtfSubscriptionld 


"the NtfSubscription identified by subscriptionid input parameter is involved in a subscription 
relationship" 



6.6.1.5 Post-condition 

filterUpdated. 



Assertion Name 


Definition 


filterUpdated 


"ntfFilter attribute value of the NtfSubscription identified by subscriptionid input parameter has 
been set to the value of the filter input parameter" 



6.6.1.6 



Exceptions 



Name 


Definition 


Operationjailed 


Condition: Pre-condition is false or post-condition is false 
Returned Information: The output parameter status 
Exit state: Entry State 



6.7 subscriptionSuspendOperations Interface 

6.7.1 Operation suspendSubscription (O) 



6.7.1.1 



Definition 



IRPManager invokes this operation to request IRP Agent to stop emission of notifications. IRP Agent may lose 
notification(s) if subscription is suspended. 



6.7.1.2 



Input parameters 



Parameter 
Name 


Qualifier 


Information Type 


Comment 


subscriptionid 


M 


NtfSubscription. ntfSubscriptionId 


It carries the subscriptionid carried as the output parameter 
in the subscribe operation. 



6.7.1.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (Operation succeeded. 
Operation failed) 


If subscriptionStateSuspended is true, status = 

OperationSuceeded. 

If operation failed is true, status = OperationFailed. 
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Assertion Name 


Definition 


validSubscriptionld 


"the NtfSubscription identified by subscriptionid input parameter is involved in a subscription 
relationship" 



6.7.1.5 Post-condition 

subscriptionStateSuspended. 



Assertion Name 


Definition 


subscriptionStateSuspended 


"ntfSubscriptionState attribute value of the NtfSubscription identified by subscriptionid 
input parameter has been set to or kept as "suspended"" 



6.7.1.6 



Exceptions 



Name 


Definition 


Operationjailed 


Condition: Pre-condition is false or post-condition is false 
Returned Information: The output parameter status 
Exit state: Entry State 



6.7.2 Operation resumeSubscription (O) 
6.7.2.1 Definition 

IRPManager invokes this operation to request IRP Agent to resume emission of notifications. 



6.7.2.2 



Input parameters 



Parameter 
Name 


Qualifier 


Information Type 


Comment 


subscriptionid 


M 


NtfSubscription. ntfSubscriptionId 


It carries the subscriptionid carried as the output parameter 
in the subscribe operation. 



6.7.2.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (Operation succeeded, 
Operation failed) 


If subscriptionStateNotSuspended is true, status = 

OperationSuceeded. 

If operationjailed is true, status = OperationFailed. 



6.7.2.4 Pre-condition 

validSubscriptionld. 



Assertion Name 



Definition 



validSubscriptionld 



"the NtfSubscription identified by subscriptionid input parameter is involved in a subscription 
relationship" 
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Assertion Name 


Definition 


subscriptionStateNotSuspended 


"ntfSubscriptionState attribute value of the NtfSubscription identified by subscriptionid 
input parameter lias been set to or l<ept as "notSuspended"" 



6.7.2.6 



Exceptions 



Name 


Definition 


Operationjailed 


Condition: Pre-condition is false or post-condition is false 
Returned Information: The output parameter status 
Exit state: Entry State 



6.8 IRPManagementOperations Interface 
6.8.1 Operation getNotificationCategories (O) 



6.8.1.1 



Definition 



IRPManager invokes this operation to query the categories of notification supported by IRP Agent. IRP Agent returns the 
list of categories of notification supported. Each category of notification defines the name and the version of the IRP 
specification. The Hst of category of notification returned shall only contain the name and version of the IRP 
specifications that actually have notifications defined. 

IRPManager does not need to be in subscription to invoke this operation. 



6.8.1.2 

None. 

6.8.1.3 



Input parameters 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


NotificationCategoryList 


M 


SET OF (name and version of IRP 
specification) where each IRP is contained by 
IRPAgent and the attribute 
notificationNameProfile of the 
IVIanagedGenericIRP is not empty. 




status 


M 


ENUIVI (Operation succeeded, Operation failed) 


OperationFailed only if 
operation_failed_internal_problem 



6.8.1.4 

None specific. 

6.8.1.5 

None specific. 

6.8.1.6 

None specific. 



Pre-condition 



Post-condition 



Exceptions 
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6.9 



Notification I RPNotification Interface 



IRP Agent notifies the subscribed IRPManager that an event has occurred and that the event has satisfied the fiher 
constraints used for this subscription. One event example is the notification defined in Alarm IRP: IS 
(3GPPTS 32.111-2 [1]). 

It should be possible to pack multiple notifications together for sending to NM. This provides more efficient use of data 
communication resources. In order to pack multiple notifications, an EM/NE configurable parameter defines the 
maximum number of notifications to be packed together. Additionally an EM/NE configurable parameter defines the 
maximum time delay before the notifications have to be sent. 

Under normal operations, an IRP Agent shall send, to each IRPManager, notifications in the same order they were 
generated, i.e. in the First-In, First-Out order. There shall not be any priority given to types of notifications. 

This interface doesn't define any specific notification but instead defines information that is commonly found in 
notifications defined by other IRPs. This information is called notificationHeader. Notification interfaces defined in 
other IRPs, such as Alarm IRP: IS (3GPP TS 32.111-2 [1]), shall inherit from this interface and define their 
notifications by: 

• Identifying and qualifying the Notification Header attributes for their use; 

• Specify additional attributes specific to their use. 

Despite the fact that the semantic of notifications is defined by other IRP ISs, it is notification IRP and not those IRP 
that is responsible for the emission of those notifications. 

The Notification Header is defined here below. 



Attribute 
Name 


Qualifier 


Comment 


objectClass 


M, F 


It specifies tlie class name of the IOC. A networl< event has occurred in an instance of this 
class. 


objectlnstance 


M, F 


It specifies the instance of the above IOC in which the network event occurred by carrying the 
Distinguished Name (DN) of this object instance. This object may or may not be identical to 
the object instance actually emitting the notification. 


notificationid 





This is an identifier for the notification, which may be used to correlate notifications. The 

identifier of the notification shall be chosen to be unique across all notifications of a particular 

managed object throughout the time that correlation is significant, it uniquely identifies the 

notification from other notifications generated by the subject Information Object. 

If IRPManager receives notifications from one IRPAgent, IRPManager shall use the identifier 

of the notification and the objectlnstance to uniquely identify all received notifications. 

If IRPManager receives notifications from multiple IRPAgents and notifications of each 

Information Object are reported at most through one IRPAgent, IRPManager shall use the 

identifier of the notification and objectlnstance to uniquely identify all received 

notifications. 

If IRPManager receives notifications from multiple IRPAgents and notifications of one or more 

Information Objects are reported through two or more IRPAgents, IRPManager shall use the 

identifier of the notification together with objectlnstance and the identity of IRPAgent 

(systemDN), to uniquely identify all received notifications. If the information systemDN is 

absent, IRPManager needs other means, which are outside the scope of this IRP, to 

determine the identity of IRPAgent. 

How identifiers of notifications are re-used to correlate notifications is outside of the scope of 

this recommendation. 


eventJime 


M, F 


It indicates the event occurrence time. The semantics of Generalised Time specified by ITU-T 
shall be used here. 


systemDN 


C, F 


It carries the Distinguished Name (DN) of IRPAgent that detects the network event and 
generates the notification. See "Name Convention for Managed Objects" [3] for name 
convention regarding DN. 


notificationType 


M, F 


The type of notification which is reported by the notification. 
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Annex A (informative): 
Change history 
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